<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr">
	<head>
		<title>PPD15 - Lisez-moi</title>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
		<style type="text/css">
body {
	font-family: arial, serif;
	font-size: 11pt;
	margin: 0;
	padding: 2em;
}
h1 {
	color: #36383D;
}
h2 {
	background-color: #36383D;
	color: white;
	padding: 2px;
	text-indent: 1em;
}
div {
	padding-left: 2em;
}
code {
	background-color: #FFF0C0;
}
table.infotab {
	border-collapse: collapse;
}
table.infotab td, table.infotab th {
	border: 1px solid black;
	padding: 0.3em;
}
table.infotab th {
	background-color: silver;
}
		</style>
	</head>
	<body>
<h1>PPD15</h1>
<h2>Sommaire</h2>
<div>
	<ul>
		<li><a href="#how-to-play">Comment jouer ?</a></li>
		<li><a href="#how-to-editor">Comment utiliser l'éditeur de cartes ?</a></li>
	</ul>
</div>

<h2 id="how-to-play">Comment jouer ?</h2>
<div>
	<h3>Liste des touches :</h3>
	<table class="infotab">
	<tr>
		<th>Touche</th>
		<th>Action</th>
	</tr>
	<tr>
		<td>Flèches directionnelles</td>
		<td>Déplacer le joueur, naviguer dans l'inventaire</td>
	</tr>
	<tr>
		<td>Espace</td>
		<td>Utiliser l'objet 1 / Assigner l'objet 1 dans l'inventaire</td>
	</tr>
	<tr>
		<td>A</td>
		<td>Utiliser l'objet 2 / Assigner l'objet 2 dans l'inventaire</td>
	</tr>
	<tr>
		<td>Z</td>
		<td>Utiliser l'objet 3 / Assigner l'objet 3 dans l'inventaire</td>
	</tr>
	<tr>
		<td>C</td>
		<td>Ouvrir la mini-carte</td>
	</tr>
	<tr>
		<td>P</td>
		<td>Ouvrir/fermer le menu pause</td>
	</tr>
	<tr>
		<td>I</td>
		<td>Ouvrir/fermer l'inventaire</td>
	</tr>
	<tr>
		<td>Page Haut</td>
		<td>Positionner le panneau de contrôle en haut</td>
	</tr>
	<tr>
		<td>Page Bas</td>
		<td>Positionner le panneau de contrôle en bas</td>
	</tr>
	<tr>
		<td>F1</td>
		<td>Prendre une capture d'écran (capture sauvée dans le répertoire <code>screenshot/</code>)</td>
	</tr>
	<tr>
		<td>S</td>
		<td>Enregistrer la partie (la dernière sauvegarde est chargée automatiquement)</td>
	</tr>
	<tr>
		<td>Échap</td>
		<td>Quitter</td>
	</tr>
	</table>
	<h3>Actions</h3>
	<ul>
		<li>
			Déplacer un objet :<br />
			Certains objets peuvent être déplacés en les poussant : placez-vous contre l'objet et continuer à avancer contre lui pendant 1 seconde pour le mettre en mouvement
		</li>
	</ul>
	
	<h3>Configuration</h3>
	<p>Deux fichiers de configuration sont utilisés :</p>
	<ul>
		<li><code>config/config.cfg</code> : contient les préférences du jeu (emplacement du panel, musique, ...)<br />
		Vous pouvez supprimer ce fichier si vous souhaitez retrouver la configuration par défaut
		</li>
		<li><code>config/save.cfg</code> : contient la sauvegarde de la progression du joueur<br />
		Vous pouvez supprimer ce fichier si vous souhaitez recommencer le jeu à zéro
		</li>
	</ul>
</div>

<h2 id="how-to-editor">Comment utiliser l'éditeur de cartes ?</h2>
<div>
	<p>L'éditeur nécessite <strong>Python</strong> et <strong>PyQt4</strong> (sous Linux Debian ou Ubuntu, installez le paquet <code>python-qt4</code>)</p>
	<p>Cliquez sur <code>Editor.py</code> pour lancer l'éditeur, ou lancez la commande <code>./Editor.py</code> en console (le chemin de la carte à ouvrir peut être passé en argument de la ligne de commande, par exemple : <code>./Editor.py ../bin/data/map/world.xml</code>)</p>
	<h3>Raccourcis clavier :</h3>
	<table class="infotab">
		<tr>
			<th>Raccourci</th>
			<th>Fonction</th>
		</tr>
		<tr>
			<td>Ctrl+N</td>
			<td>Créer une nouvelle carte</td>
		</tr>
		<tr>
			<td>Ctrl+O</td>
			<td>Ouvrir une carte</td>
		</tr>
		<tr>
			<td>Ctrl+S</td>
			<td>Enregistrer la carte</td>
		</tr>
		<tr>
			<td>Ctrl+Shit+S</td>
			<td>Enregistrer la carte sous un autre nom de fichier</td>
		</tr>
		<tr>
			<td>Ctrl+Q</td>
			<td>Quitter l'éditeur</td>
		</tr>
		<tr>
			<td>U</td>
			<td>Annuler le dernier placement de tile</td>
		</tr>
		<tr>
			<td>D</td>
			<td>Déplacer une entité</td>
		</tr>
		<tr>
			<td>S</td>
			<td>Supprimer une entité</td>
		</tr>
		<tr>
			<td>Flèches directionnelles</td>
			<td>Se déplacer dans les zones</td>
		</tr>
		<tr>
			<td>G</td>
			<td>Afficher/masquer la grille</td>
		</tr>
	</table>
	<h3>Positionner des tiles</h3>
	<p>
	Choisissez une tile dans le tileset en cliquant dessus (partie gauche de l'écran), puis cliquez dans la zone (partie droite) pour positionner la tile. Maintenez le bouton de la souris enfoncé en la déplaçant pour placer plusieurs tiles à la fois.<br />
	Les placements peuvent être annulés avec l'option <em>Édition > Annuler tile</em>.<br />
	Pour remplir toute la zone avec une tile, utilisez l'option <em>Édition > Peindre avec la tile courante</em>.
	</p>
	<h3>Déplacer une entité</h3>
	<p>Cliquez sur l'entité à déplacer (celle-ci se mettra à suivre le curseur), puis cliquez sur la nouvelle position de l'entité.</p>
	<h3>Supprimer une entité</h3>
	<p>Cliquez sur l'entité à supprimer.</p>
	
	<p>
		<strong>Attention</strong>, ajouter des lignes ou des colonnes de zones dans une carte peut invalider les destinations des téléporteurs en raison d'un éventuel décalage de la position de la zone cible. Cela implique aussi bien les téléporteurs de la carte éditée, que les téléporteurs des autres cartes faisant référence à la carte éditée.
	</p>
	<h3>Fichier de configuration</h3>
	<p>L'éditeur utilise le fichier de configuration <code>editor/config/config.txt</code> pour définir l'emplacement des fichiers ressources.</p>
	<p>Les valeurs suivantes doivent s'y trouver (syntaxe <code>clef = valeur</code>) :</p>
	<ul>
		<li><code>map_path</code> : répertoire par défaut des fichiers cartes</li>
		<li><code>units</code> : chemin du fichier XML des définitions des unités</li>
		<li><code>decors</code> : chemin du fichier XML des définitions des décors</li>
		<li><code>tileset</code> : chemin de l'image du tileset</li>
		<li><code>musics</code> : chemin de la liste des musiques du jeu</li>
		<li><code>tilesize</code> : taille du côté d'une tile (en pixels)</li>
	</ul>
</div>
	</body>
</html>

